Skip to content

doc: add components api doc#85

Open
bcho wants to merge 2 commits intomainfrom
hbc/components-api
Open

doc: add components api doc#85
bcho wants to merge 2 commits intomainfrom
hbc/components-api

Conversation

@bcho
Copy link
Member

@bcho bcho commented Feb 17, 2026

This pull request proposes a new components organization process for managing the flex node lifecycle (baking/bootstrapping/updating etc).

The new node join process can be completed by a single command on a user provided configuration file:

aks-flex-node apply -f <config.json>

Sample configuration:

[
  {
    "metadata": {
      "type": "aks.flex.components.linux.v20260301.ConfigureBaseOS",
      "name": "configure-base-os"
    },
    "spec": {}
  },
  {
    "metadata": {
      "type": "aks.flex.components.cri.v20260301.DownloadCRIBinaries",
      "name": "download-cri-binaries"
    },
    "spec": {
      "containerd_version": "2.0.4",
      "runc_version": "1.2.5"
    }
  },
  {
    "metadata": {
      "type": "aks.flex.components.kubebins.v20260301.DownloadKubeBinaries",
      "name": "download-kube-binaries"
    },
    "spec": {
      "kubernetes_version": "1.32.3"
    }
  },
  {
    "metadata": {
      "type": "aks.flex.components.cri.v20260301.StartContainerdService",
      "name": "start-containerd-service"
    },
    "spec": {}
  },
  {
    "metadata": {
      "type": "aks.flex.components.kubeadm.v20260301.KubadmNodeJoin",
      "name": "kubeadm-node-join"
    },
    "spec": {
      "control_plane": {
        "server": "https://<fqdn>:443",
        "certificate_authority_data": "<ca>"
      },
      "kubelet": {
        "bootstrap_auth_info": {
          "token": "<bootstrap-token>"
        },
        "node_labels": {
          "kubernetes.azure.com/managed": "false",
          "kubernetes.azure.com/cluster": "<cluster-info>"
        }
      }
    }
  }
]

A full implementation of this design can be found in #83 (demo has been shared internally).

Related:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant